

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  <title>Button matrix (lv_btnm) &mdash; LittlevGL 6.1.2 documentation</title>
  

  
  
    <link rel="shortcut icon" href="../_static/favicon.ico"/>
  
  
  

  
  <script type="text/javascript" src="../_static/js/modernizr.min.js"></script>
  
    
      <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
        <script src="../_static/jquery.js"></script>
        <script src="../_static/underscore.js"></script>
        <script src="../_static/doctools.js"></script>
        <script src="../_static/language_data.js"></script>
    
    <script type="text/javascript" src="../_static/js/theme.js"></script>

    

  
  <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
  <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
  <link rel="stylesheet" href="../_static/css/custom.css" type="text/css" />
  <link rel="stylesheet" href="../_static/css/fontawesome.min.css" type="text/css" />
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="Calendar (lv_calendar)" href="calendar.html" />
    <link rel="prev" title="Button (lv_btn)" href="btn.html" />
 
<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-78811084-3"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-78811084-3');
</script>

</head>

<body class="wy-body-for-nav">

   
  <div class="wy-grid-for-nav">
    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
      <div class="wy-side-scroll">
        <div class="wy-side-nav-search" >
          

          
            <a href="../index.html">
          

          
            
            <img src="../_static/white_white_lvgl_full_logo.svg" class="logo" alt="Logo"/>
          
          </a>

          
            
            
              <div class="version">
                6.1.2
              </div>
            
          

          
<div role="search">
  <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
    <input type="hidden" name="check_keywords" value="yes" />
    <input type="hidden" name="area" value="default" />
  </form>
</div>

          
        </div>

        <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
          
            
            
              
            
            
              <ul class="current">
<li class="toctree-l1"><a class="reference internal" href="../get-started/index.html">Get started</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../get-started/live-demo.html">Live demos</a></li>
<li class="toctree-l2"><a class="reference internal" href="../get-started/pc-simulator.html">Simulator on PC</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../get-started/pc-simulator.html#select-an-ide">Select an IDE</a></li>
<li class="toctree-l3"><a class="reference internal" href="../get-started/pc-simulator.html#set-up-eclipse-cdt">Set-up Eclipse CDT</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../get-started/pc-simulator.html#install-eclipse-cdt">Install Eclipse CDT</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/pc-simulator.html#install-sdl-2">Install SDL 2</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/pc-simulator.html#pre-configured-project">Pre-configured project</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/pc-simulator.html#add-the-pre-configured-project-to-eclipse-cdt">Add the pre-configured project to Eclipse CDT</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/pc-simulator.html#compile-and-run">Compile and Run</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../get-started/quick-overview.html">Quick overview</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../get-started/quick-overview.html#add-littlevgl-into-your-project">Add LittlevGL into your project</a></li>
<li class="toctree-l3"><a class="reference internal" href="../get-started/quick-overview.html#learn-the-basics">Learn the basics</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../get-started/quick-overview.html#objects-widgets">Objects (Widgets)</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/quick-overview.html#styles">Styles</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/quick-overview.html#events">Events</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../get-started/quick-overview.html#examples">Examples</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../get-started/quick-overview.html#button-with-label">Button with label</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/quick-overview.html#button-with-styles">Button with styles</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/quick-overview.html#slider-and-object-alignment">Slider and object alignment</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/quick-overview.html#list-and-themes">List and themes</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/quick-overview.html#use-littlevgl-from-micropython">Use LittlevGL from Micropython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../get-started/quick-overview.html#contributing">Contributing</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../get-started/micropython.html">Micropython</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../get-started/micropython.html#what-is-micropython">What is Micropython?</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../get-started/micropython.html#highlights-of-micropython">Highlights of Micropython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../get-started/micropython.html#why-micropython-littlevgl">Why Micropython + LittlevGL?</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../get-started/micropython.html#here-are-some-advantages-of-using-littlevgl-in-micropython">Here are some advantages of using LittlevGL in Micropython:</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/micropython.html#micropython-littlevgl-could-be-used-for">Micropython + LittlevGL could be used for:</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../get-started/micropython.html#so-what-does-it-look-like">So what does it look like?</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../get-started/micropython.html#a-simple-example">A simple example</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../get-started/micropython.html#how-can-i-use-it">How can I use it?</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../get-started/micropython.html#online-simulator">Online Simulator</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/micropython.html#pc-simulator">PC Simulator</a></li>
<li class="toctree-l4"><a class="reference internal" href="../get-started/micropython.html#embedded-platform">Embedded platform</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../get-started/micropython.html#where-can-i-find-more-information">Where can I find more information?</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../porting/index.html">Porting</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../porting/sys.html">System overview</a></li>
<li class="toctree-l2"><a class="reference internal" href="../porting/project.html">Set-up a project</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../porting/project.html#get-the-library">Get the library</a></li>
<li class="toctree-l3"><a class="reference internal" href="../porting/project.html#configuration-file">Configuration file</a></li>
<li class="toctree-l3"><a class="reference internal" href="../porting/project.html#initialization">Initialization</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../porting/display.html">Display interface</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../porting/display.html#display-buffer">Display buffer</a></li>
<li class="toctree-l3"><a class="reference internal" href="../porting/display.html#display-driver">Display driver</a></li>
<li class="toctree-l3"><a class="reference internal" href="../porting/display.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../porting/indev.html">Input device interface</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../porting/indev.html#types-of-input-devices">Types of input devices</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../porting/indev.html#touchpad-mouse-or-any-pointer">Touchpad, mouse or any pointer</a></li>
<li class="toctree-l4"><a class="reference internal" href="../porting/indev.html#keypad-or-keyboard">Keypad or keyboard</a></li>
<li class="toctree-l4"><a class="reference internal" href="../porting/indev.html#encoder">Encoder</a></li>
<li class="toctree-l4"><a class="reference internal" href="../porting/indev.html#button">Button</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../porting/indev.html#other-features">Other features</a></li>
<li class="toctree-l3"><a class="reference internal" href="../porting/indev.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../porting/tick.html">Tick interface</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../porting/tick.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../porting/task-handler.html">Task Handler</a></li>
<li class="toctree-l2"><a class="reference internal" href="../porting/sleep.html">Sleep management</a></li>
<li class="toctree-l2"><a class="reference internal" href="../porting/os.html">Operating system and interrupts</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../porting/os.html#tasks-and-threads">Tasks and threads</a></li>
<li class="toctree-l3"><a class="reference internal" href="../porting/os.html#interrupts">Interrupts</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../porting/log.html">Logging</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../porting/log.html#log-level">Log level</a></li>
<li class="toctree-l3"><a class="reference internal" href="../porting/log.html#logging-with-printf">Logging with printf</a></li>
<li class="toctree-l3"><a class="reference internal" href="../porting/log.html#custom-log-function">Custom log function</a></li>
<li class="toctree-l3"><a class="reference internal" href="../porting/log.html#add-logs">Add logs</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../overview/index.html">Overview</a><ul>
<li class="toctree-l2"><a class="reference internal" href="../overview/object.html">Objects</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/object.html#object-attributes">Object attributes</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/object.html#basic-attributes">Basic attributes</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/object.html#specific-attributes">Specific attributes</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/object.html#object-s-working-mechanisms">Object’s working mechanisms</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/object.html#parent-child-structure">Parent-child structure</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/object.html#moving-together">Moving together</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/object.html#visibility-only-on-the-parent">Visibility only on the parent</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/object.html#create-delete-objects">Create - delete objects</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/object.html#screen-the-most-basic-parent">Screen – the most basic parent</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/layer.html">Layers</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/layer.html#order-of-creation">Order of creation</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/layer.html#bring-to-the-foreground">Bring to the foreground</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/layer.html#top-and-sys-layers">Top and sys layers</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/event.html">Events</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/event.html#event-types">Event types</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/event.html#generic-events">Generic events</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/event.html#special-events">Special events</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/event.html#custom-data">Custom data</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/event.html#send-events-manually">Send events manually</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/style.html">Styles</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/style.html#use-the-styles">Use the styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/style.html#inherit-styles">Inherit styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/style.html#style-properties">Style properties</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/style.html#common-properties">Common properties</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/style.html#body-style-properties">Body style properties</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/style.html#text-style-properties">Text style properties</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/style.html#image-style-properties">Image style properties</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/style.html#line-style-properties">Line style properties</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/style.html#built-in-styles">Built-in styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/style.html#create-new-styles">Create new styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/style.html#style-animations">Style animations</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/style.html#style-example">Style example</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/style.html#themes">Themes</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/style.html#live-update">Live update</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/indev.html">Input devices</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/indev.html#pointers">Pointers</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/indev.html#keypad-and-encoder">Keypad and encoder</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/indev.html#groups">Groups</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/indev.html#complete-example">Complete example</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/indev.html#api">API</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/indev.html#input-device">Input device</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/indev.html#id1">Groups</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/display.html">Displays</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/display.html#using-only-one-display">Using only one display</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/display.html#mirror-display">Mirror display</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/display.html#split-image">Split image</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/display.html#screens">Screens</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/display.html#opaque-screen">Opaque screen</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/display.html#features-of-displays">Features of displays</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/display.html#inactivity">Inactivity</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/display.html#colors">Colors</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/display.html#convert-color">Convert color</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/display.html#swap-16-colors">Swap 16 colors</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/display.html#create-and-mix-colors">Create and mix colors</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/display.html#opacity">Opacity</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/display.html#built-in-colors">Built-in colors</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/display.html#api">API</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/display.html#display">Display</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/display.html#id1">Colors</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/font.html">Fonts</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/font.html#unicode-support">Unicode support</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/font.html#built-in-fonts">Built-in fonts</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/font.html#special-features">Special features</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/font.html#bidirectional-support">Bidirectional support</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/font.html#subpixel-rendering">Subpixel rendering</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/font.html#compress-fonts">Compress fonts</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/font.html#add-new-font">Add new font</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/font.html#add-new-symbols">Add new symbols</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/font.html#add-a-new-font-engine">Add a new font engine</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/image.html">Images</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/image.html#store-images">Store images</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#variables">Variables</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#files">Files</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/image.html#color-formats">Color formats</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/image.html#add-and-use-images">Add and use images</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#online-converter">Online converter</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#manually-create-an-image">Manually create an image</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#use-images">Use images</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/image.html#image-decoder">Image decoder</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#custom-image-formats">Custom image formats</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#register-an-image-decoder">Register an image decoder</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#manually-use-an-image-decoder">Manually use an image decoder</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/image.html#image-caching">Image caching</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#cache-size">Cache size</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#value-of-images">Value of images</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#memory-usage">Memory usage</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#clean-the-cache">Clean the cache</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="../overview/image.html#api">API</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#id1">Image decoder</a></li>
<li class="toctree-l4"><a class="reference internal" href="../overview/image.html#image-cache">Image cache</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/file-system.html">File system</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/file-system.html#add-a-driver">Add a driver</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/file-system.html#usage-example">Usage example</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/file-system.html#use-drivers-for-images">Use drivers for images</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/file-system.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/animation.html">Animations</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/animation.html#create-an-animation">Create an animation</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/animation.html#animation-path">Animation path</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/animation.html#speed-vs-time">Speed vs time</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/animation.html#delete-animations">Delete animations</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/animation.html#api">API</a><ul>
<li class="toctree-l4"><a class="reference internal" href="../overview/animation.html#input-device">Input device</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/task.html">Tasks</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/task.html#create-a-task">Create a task</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/task.html#ready-and-reset">Ready and Reset</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/task.html#set-parameters">Set parameters</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/task.html#one-shot-tasks">One-shot tasks</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/task.html#measure-idle-time">Measure idle time</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/task.html#asynchronous-calls">Asynchronous calls</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/task.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="../overview/drawing.html">Drawing</a><ul>
<li class="toctree-l3"><a class="reference internal" href="../overview/drawing.html#buffering-types">Buffering types</a></li>
<li class="toctree-l3"><a class="reference internal" href="../overview/drawing.html#mechanism-of-screen-refreshing">Mechanism of screen refreshing</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Object types (Widgets)</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="obj.html">Base object (lv_obj)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="obj.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="obj.html#coordinates">Coordinates</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#parents-and-children">Parents and children</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#screens">Screens</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#layers">Layers</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#style">Style</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#events">Events</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#attributes">Attributes</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#opa-scale">Opa scale</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#protect">Protect</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#groups">Groups</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#extended-click-area">Extended click area</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="obj.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="obj.html#id1">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="obj.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="obj.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="obj.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="obj.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="obj.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="arc.html">Arc (lv_arc)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="arc.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="arc.html#angles">Angles</a></li>
<li class="toctree-l4"><a class="reference internal" href="arc.html#notes">Notes</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="arc.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="arc.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="arc.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="arc.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="arc.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="arc.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="arc.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="bar.html">Bar (lv_bar)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="bar.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="bar.html#value-and-range">Value and range</a></li>
<li class="toctree-l4"><a class="reference internal" href="bar.html#symmetrical">Symmetrical</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="bar.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="bar.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="bar.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="bar.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="bar.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="bar.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="bar.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="btn.html">Button (lv_btn)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="btn.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="btn.html#states">States</a></li>
<li class="toctree-l4"><a class="reference internal" href="btn.html#toggle">Toggle</a></li>
<li class="toctree-l4"><a class="reference internal" href="btn.html#layout-and-fit">Layout and Fit</a></li>
<li class="toctree-l4"><a class="reference internal" href="btn.html#ink-effect">Ink effect</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="btn.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="btn.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="btn.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="btn.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="btn.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="btn.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="btn.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">Button matrix (lv_btnm)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#button-s-text">Button’s text</a></li>
<li class="toctree-l4"><a class="reference internal" href="#control-buttons">Control buttons</a></li>
<li class="toctree-l4"><a class="reference internal" href="#one-toggle">One toggle</a></li>
<li class="toctree-l4"><a class="reference internal" href="#recolor">Recolor</a></li>
<li class="toctree-l4"><a class="reference internal" href="#notes">Notes</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="calendar.html">Calendar (lv_calendar)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="calendar.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="calendar.html#current-date">Current date</a></li>
<li class="toctree-l4"><a class="reference internal" href="calendar.html#shown-date">Shown date</a></li>
<li class="toctree-l4"><a class="reference internal" href="calendar.html#highlighted-days">Highlighted days</a></li>
<li class="toctree-l4"><a class="reference internal" href="calendar.html#name-of-the-days">Name of the days</a></li>
<li class="toctree-l4"><a class="reference internal" href="calendar.html#name-of-the-months">Name of the months</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="calendar.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="calendar.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="calendar.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="calendar.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="calendar.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="calendar.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="calendar.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="canvas.html">Canvas (lv_canvas)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="canvas.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="canvas.html#buffer">Buffer</a></li>
<li class="toctree-l4"><a class="reference internal" href="canvas.html#palette">Palette</a></li>
<li class="toctree-l4"><a class="reference internal" href="canvas.html#drawing">Drawing</a></li>
<li class="toctree-l4"><a class="reference internal" href="canvas.html#rotate">Rotate</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="canvas.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="canvas.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="canvas.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="canvas.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="canvas.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="canvas.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="canvas.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="cb.html">Checkbox (lv_cb)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="cb.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="cb.html#text">Text</a></li>
<li class="toctree-l4"><a class="reference internal" href="cb.html#check-uncheck">Check/Uncheck</a></li>
<li class="toctree-l4"><a class="reference internal" href="cb.html#inactive">Inactive</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="cb.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="cb.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="cb.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="cb.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="cb.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="cb.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="cb.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="chart.html">Chart (lv_chart)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="chart.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="chart.html#data-series">Data series</a></li>
<li class="toctree-l4"><a class="reference internal" href="chart.html#series-type">Series’ type</a></li>
<li class="toctree-l4"><a class="reference internal" href="chart.html#modify-the-data">Modify the data</a></li>
<li class="toctree-l4"><a class="reference internal" href="chart.html#update-modes">Update modes</a></li>
<li class="toctree-l4"><a class="reference internal" href="chart.html#number-of-points">Number of points</a></li>
<li class="toctree-l4"><a class="reference internal" href="chart.html#vertical-range">Vertical range</a></li>
<li class="toctree-l4"><a class="reference internal" href="chart.html#division-lines">Division lines</a></li>
<li class="toctree-l4"><a class="reference internal" href="chart.html#series-appearance">Series’ appearance</a></li>
<li class="toctree-l4"><a class="reference internal" href="chart.html#tick-marks-and-labels">Tick marks and labels</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="chart.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="chart.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="chart.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="chart.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="chart.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="chart.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="chart.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="cont.html">Container (lv_cont)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="cont.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="cont.html#layout">Layout</a></li>
<li class="toctree-l4"><a class="reference internal" href="cont.html#autofit">Autofit</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="cont.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="cont.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="cont.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="cont.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="cont.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="cont.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="cont.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="cpicker.html">Color picker (lv_cpicker)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="cpicker.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="cpicker.html#types-of-color-pickers">Types of color pickers</a></li>
<li class="toctree-l4"><a class="reference internal" href="cpicker.html#notes">Notes</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="cpicker.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="cpicker.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="cpicker.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="cpicker.html#example">Example</a></li>
<li class="toctree-l3"><a class="reference internal" href="cpicker.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="ddlist.html">Drop-down list (lv_ddlist)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="ddlist.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#set-options">Set options</a></li>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#get-selected-option">Get selected option</a></li>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#align-the-options">Align the options</a></li>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#height-and-width">Height and width</a></li>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#scrollbars">Scrollbars</a></li>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#animation-time">Animation time</a></li>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#decoration-arrow">Decoration arrow</a></li>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#manually-open-close">Manually open/close</a></li>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#stay-open">Stay open</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="ddlist.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="ddlist.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="ddlist.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="ddlist.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="ddlist.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="ddlist.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="gauge.html">Gauge (lv_gauge)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="gauge.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="gauge.html#scale">Scale</a></li>
<li class="toctree-l4"><a class="reference internal" href="gauge.html#needles">Needles</a></li>
<li class="toctree-l4"><a class="reference internal" href="gauge.html#range">Range</a></li>
<li class="toctree-l4"><a class="reference internal" href="gauge.html#critical-value">Critical value</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="gauge.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="gauge.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="gauge.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="gauge.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="gauge.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="gauge.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="gauge.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="img.html">Image (lv_img)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="img.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="img.html#image-source">Image source</a></li>
<li class="toctree-l4"><a class="reference internal" href="img.html#label-as-an-image">Label as an image</a></li>
<li class="toctree-l4"><a class="reference internal" href="img.html#transparency">Transparency</a></li>
<li class="toctree-l4"><a class="reference internal" href="img.html#palette-and-alpha-index">Palette and Alpha index</a></li>
<li class="toctree-l4"><a class="reference internal" href="img.html#recolor">Recolor</a></li>
<li class="toctree-l4"><a class="reference internal" href="img.html#auto-size">Auto-size</a></li>
<li class="toctree-l4"><a class="reference internal" href="img.html#mosaic">Mosaic</a></li>
<li class="toctree-l4"><a class="reference internal" href="img.html#offset">Offset</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="img.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="img.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="img.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="img.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="img.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="img.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="img.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="imgbtn.html">Image button (lv_imgbtn)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="imgbtn.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="imgbtn.html#image-sources">Image sources</a></li>
<li class="toctree-l4"><a class="reference internal" href="imgbtn.html#states">States</a></li>
<li class="toctree-l4"><a class="reference internal" href="imgbtn.html#toggle">Toggle</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="imgbtn.html#style-usage">Style usage</a></li>
<li class="toctree-l3"><a class="reference internal" href="imgbtn.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="imgbtn.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="imgbtn.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="imgbtn.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="imgbtn.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="imgbtn.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="kb.html">Keyboard (lv_kb)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="kb.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="kb.html#modes">Modes</a></li>
<li class="toctree-l4"><a class="reference internal" href="kb.html#assign-text-area">Assign Text area</a></li>
<li class="toctree-l4"><a class="reference internal" href="kb.html#new-keymap">New Keymap</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="kb.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="kb.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="kb.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="kb.html#examples">Examples</a><ul>
<li class="toctree-l4"><a class="reference internal" href="kb.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="kb.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="kb.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="label.html">Label (lv_label)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="label.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="label.html#set-text">Set text</a></li>
<li class="toctree-l4"><a class="reference internal" href="label.html#line-break">Line break</a></li>
<li class="toctree-l4"><a class="reference internal" href="label.html#long-modes">Long modes</a></li>
<li class="toctree-l4"><a class="reference internal" href="label.html#text-align">Text align</a></li>
<li class="toctree-l4"><a class="reference internal" href="label.html#draw-background">Draw background</a></li>
<li class="toctree-l4"><a class="reference internal" href="label.html#text-recolor">Text recolor</a></li>
<li class="toctree-l4"><a class="reference internal" href="label.html#very-long-texts">Very long texts</a></li>
<li class="toctree-l4"><a class="reference internal" href="label.html#symbols">Symbols</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="label.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="label.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="label.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="label.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="label.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="label.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="label.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="led.html">LED (lv_led)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="led.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="led.html#brightness">Brightness</a></li>
<li class="toctree-l4"><a class="reference internal" href="led.html#toggle">Toggle</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="led.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="led.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="led.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="led.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="led.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="led.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="led.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="line.html">Line (lv_line)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="line.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="line.html#set-points">Set points</a></li>
<li class="toctree-l4"><a class="reference internal" href="line.html#auto-size">Auto-size</a></li>
<li class="toctree-l4"><a class="reference internal" href="line.html#invert-y">Invert y</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="line.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="line.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="line.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="line.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="line.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="line.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="line.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="list.html">List (lv_list)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="list.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="list.html#add-buttons">Add buttons</a></li>
<li class="toctree-l4"><a class="reference internal" href="list.html#delete-buttons">Delete buttons</a></li>
<li class="toctree-l4"><a class="reference internal" href="list.html#manual-navigation">Manual navigation</a></li>
<li class="toctree-l4"><a class="reference internal" href="list.html#layout">Layout</a></li>
<li class="toctree-l4"><a class="reference internal" href="list.html#edge-flash">Edge flash</a></li>
<li class="toctree-l4"><a class="reference internal" href="list.html#scroll-propagation">Scroll propagation</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="list.html#style-usage">Style usage</a></li>
<li class="toctree-l3"><a class="reference internal" href="list.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="list.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="list.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="list.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="list.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="list.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="lmeter.html">Line meter (lv_lmeter)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="lmeter.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="lmeter.html#set-value">Set value</a></li>
<li class="toctree-l4"><a class="reference internal" href="lmeter.html#range-and-angles">Range and Angles</a></li>
<li class="toctree-l4"><a class="reference internal" href="lmeter.html#angle-offset">Angle offset</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="lmeter.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="lmeter.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="lmeter.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="lmeter.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="lmeter.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="lmeter.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="lmeter.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="mbox.html">Message box (lv_mbox)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="mbox.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="mbox.html#set-text">Set text</a></li>
<li class="toctree-l4"><a class="reference internal" href="mbox.html#add-buttons">Add buttons</a></li>
<li class="toctree-l4"><a class="reference internal" href="mbox.html#auto-close">Auto-close</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="mbox.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbox.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="mbox.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="mbox.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="mbox.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="mbox.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="page.html">Page (lv_page)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="page.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="page.html#scrollbars">Scrollbars</a></li>
<li class="toctree-l4"><a class="reference internal" href="page.html#glue-object">Glue object</a></li>
<li class="toctree-l4"><a class="reference internal" href="page.html#focus-object">Focus object</a></li>
<li class="toctree-l4"><a class="reference internal" href="page.html#manual-navigation">Manual navigation</a></li>
<li class="toctree-l4"><a class="reference internal" href="page.html#edge-flash">Edge flash</a></li>
<li class="toctree-l4"><a class="reference internal" href="page.html#scroll-propagation">Scroll propagation</a></li>
<li class="toctree-l4"><a class="reference internal" href="page.html#scrollable-api">Scrollable API</a></li>
<li class="toctree-l4"><a class="reference internal" href="page.html#notes">Notes</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="page.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="page.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="page.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="page.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="page.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="page.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="preload.html">Preloader (lv_preload)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="preload.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preload.html#arc-length">Arc length</a></li>
<li class="toctree-l4"><a class="reference internal" href="preload.html#spinning-speed">Spinning speed</a></li>
<li class="toctree-l4"><a class="reference internal" href="preload.html#spin-types">Spin types</a></li>
<li class="toctree-l4"><a class="reference internal" href="preload.html#spin-direction">Spin direction</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="preload.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="preload.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="preload.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="preload.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="preload.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="preload.html#id1">MicroPython</a></li>
<li class="toctree-l4"><a class="reference internal" href="preload.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="preload.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="roller.html">Roller (lv_roller)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="roller.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="roller.html#set-options">Set options</a></li>
<li class="toctree-l4"><a class="reference internal" href="roller.html#get-selected-option">Get selected option</a></li>
<li class="toctree-l4"><a class="reference internal" href="roller.html#align-the-options">Align the options</a></li>
<li class="toctree-l4"><a class="reference internal" href="roller.html#height-and-width">Height and width</a></li>
<li class="toctree-l4"><a class="reference internal" href="roller.html#animation-time">Animation time</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="roller.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="roller.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="roller.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="roller.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="roller.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="roller.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="roller.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="slider.html">Slider (lv_slider)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="slider.html#overview">Overview</a></li>
<li class="toctree-l3"><a class="reference internal" href="slider.html#value-and-range">Value and range</a><ul>
<li class="toctree-l4"><a class="reference internal" href="slider.html#symmetrical">Symmetrical</a></li>
<li class="toctree-l4"><a class="reference internal" href="slider.html#knob-placement">Knob placement</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="slider.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="slider.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="slider.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="slider.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="slider.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="slider.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="slider.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="spinbox.html">Spinbox (lv_spinbox)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="spinbox.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="spinbox.html#set-format">Set format</a></li>
<li class="toctree-l4"><a class="reference internal" href="spinbox.html#value-and-ranges">Value and ranges</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="spinbox.html#style-usage">Style usage</a></li>
<li class="toctree-l3"><a class="reference internal" href="spinbox.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="spinbox.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="spinbox.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="spinbox.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="spinbox.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="spinbox.html#api">API</a></li>
<li class="toctree-l3"><a class="reference internal" href="spinbox.html#id1">Example</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="sw.html">Switch (lv_sw)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="sw.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="sw.html#change-state">Change state</a></li>
<li class="toctree-l4"><a class="reference internal" href="sw.html#animation-time">Animation time</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="sw.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="sw.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="sw.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="sw.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="sw.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="sw.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="sw.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="table.html">Table (lv_table)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="table.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="table.html#rows-and-columns">Rows and Columns</a></li>
<li class="toctree-l4"><a class="reference internal" href="table.html#width-and-height">Width and Height</a></li>
<li class="toctree-l4"><a class="reference internal" href="table.html#set-cell-value">Set cell value</a></li>
<li class="toctree-l4"><a class="reference internal" href="table.html#align">Align</a></li>
<li class="toctree-l4"><a class="reference internal" href="table.html#cell-type">Cell type</a></li>
<li class="toctree-l4"><a class="reference internal" href="table.html#merge-cells">Merge cells</a></li>
<li class="toctree-l4"><a class="reference internal" href="table.html#crop-text">Crop text</a></li>
<li class="toctree-l4"><a class="reference internal" href="table.html#scroll">Scroll</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="table.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="table.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="table.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="table.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="table.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="table.html#id1">MicroPython</a></li>
<li class="toctree-l4"><a class="reference internal" href="table.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="table.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="tabview.html">Tabview (lv_tabview)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="tabview.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="tabview.html#adding-tab">Adding tab</a></li>
<li class="toctree-l4"><a class="reference internal" href="tabview.html#change-tab">Change tab</a></li>
<li class="toctree-l4"><a class="reference internal" href="tabview.html#tab-button-s-position">Tab button’s position</a></li>
<li class="toctree-l4"><a class="reference internal" href="tabview.html#hide-the-tabs">Hide the tabs</a></li>
<li class="toctree-l4"><a class="reference internal" href="tabview.html#animation-time">Animation time</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="tabview.html#style-usage">Style usage</a></li>
<li class="toctree-l3"><a class="reference internal" href="tabview.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="tabview.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="tabview.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="tabview.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="tabview.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="tabview.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="ta.html">Text area (lv_ta)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="ta.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="ta.html#add-text">Add text</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#placeholder">Placeholder</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#delete-character">Delete character</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#move-the-cursor">Move the cursor</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#cursor-types">Cursor types</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#one-line-mode">One line mode</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#password-mode">Password mode</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#text-align">Text align</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#accepted-characters">Accepted characters</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#max-text-length">Max text length</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#very-long-texts">Very long texts</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#select-text">Select text</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#scrollbars">Scrollbars</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#scroll-propagation">Scroll propagation</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#edge-flash">Edge flash</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="ta.html#style-usage">Style usage</a></li>
<li class="toctree-l3"><a class="reference internal" href="ta.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="ta.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="ta.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="ta.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="ta.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="ta.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="tileview.html">Tile view (lv_tileview)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="tileview.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="tileview.html#valid-positions">Valid positions</a></li>
<li class="toctree-l4"><a class="reference internal" href="tileview.html#add-element">Add element</a></li>
<li class="toctree-l4"><a class="reference internal" href="tileview.html#set-tile">Set tile</a></li>
<li class="toctree-l4"><a class="reference internal" href="tileview.html#animation-time">Animation time</a></li>
<li class="toctree-l4"><a class="reference internal" href="tileview.html#edge-flash">Edge flash</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="tileview.html#styles">Styles</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileview.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileview.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="tileview.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="tileview.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="tileview.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="tileview.html#api">API</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="win.html">Window (lv_win)</a><ul>
<li class="toctree-l3"><a class="reference internal" href="win.html#overview">Overview</a><ul>
<li class="toctree-l4"><a class="reference internal" href="win.html#title">Title</a></li>
<li class="toctree-l4"><a class="reference internal" href="win.html#control-buttons">Control buttons</a></li>
<li class="toctree-l4"><a class="reference internal" href="win.html#scrollbars">Scrollbars</a></li>
<li class="toctree-l4"><a class="reference internal" href="win.html#manual-scroll-and-focus">Manual scroll and focus</a></li>
<li class="toctree-l4"><a class="reference internal" href="win.html#layout">Layout</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="win.html#style-usage">Style usage</a></li>
<li class="toctree-l3"><a class="reference internal" href="win.html#events">Events</a></li>
<li class="toctree-l3"><a class="reference internal" href="win.html#keys">Keys</a></li>
<li class="toctree-l3"><a class="reference internal" href="win.html#example">Example</a><ul>
<li class="toctree-l4"><a class="reference internal" href="win.html#c">C</a></li>
<li class="toctree-l4"><a class="reference internal" href="win.html#micropython">MicroPython</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="win.html#api">API</a></li>
</ul>
</li>
</ul>
</li>
</ul>

            
          
        </div>
      </div>
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" aria-label="top navigation">
        
          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
          <a href="../index.html">LittlevGL</a>
        
      </nav>


      <div class="wy-nav-content">
        
        <div class="rst-content">
        
          

















<div role="navigation" aria-label="breadcrumbs navigation">

  <ul class="wy-breadcrumbs">
    
      <li><a href="../index.html">Docs</a> &raquo;</li>
        
          <li><a href="index.html">Object types (Widgets)</a> &raquo;</li>
        
      <li>Button matrix (lv_btnm)</li>
    
    
      <li class="wy-breadcrumbs-aside">
        
            
            
              <!-- User defined GitHub URL -->
              <a href="https://github.com/littlevgl/docs/blob/master/en/object-types/btnm.md" class="fa fa-github"> Edit on GitHub</a>
            
          
        
      </li>
    
  </ul>

  
  <hr/>
</div>
          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
           <div itemprop="articleBody">
            
  <div class="section" id="button-matrix-lv-btnm">
<h1>Button matrix (lv_btnm)<a class="headerlink" href="#button-matrix-lv-btnm" title="Permalink to this headline">¶</a></h1>
<div class="section" id="overview">
<h2>Overview<a class="headerlink" href="#overview" title="Permalink to this headline">¶</a></h2>
<p>The Button Matrix objects can display <strong>multiple buttons</strong> in rows and columns.</p>
<p>The main reasons for wanting to use a button matrix instead of a container and individual button objects are:</p>
<ul class="simple">
<li><p>The button matrix is simpler to use for grid-based button layouts.</p></li>
<li><p>The button matrix consumes a lot less memory per button.</p></li>
</ul>
<div class="section" id="button-s-text">
<h3>Button’s text<a class="headerlink" href="#button-s-text" title="Permalink to this headline">¶</a></h3>
<p>There is a text on each button. To specify them a descriptor string array, called <em>map</em>, needs to be used.
The map can be set with <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_map(btnm,</span> <span class="pre">my_map)</span></code>.
The declaration of a map should look like <code class="docutils literal notranslate"><span class="pre">const</span> <span class="pre">char</span> <span class="pre">*</span> <span class="pre">map[]</span> <span class="pre">=</span> <span class="pre">{&quot;btn1&quot;,</span> <span class="pre">&quot;btn2&quot;,</span> <span class="pre">&quot;btn3&quot;,</span> <span class="pre">&quot;&quot;}</span></code>.
Note that <strong>the last element has to be an empty string</strong>!</p>
<p>Use <code class="docutils literal notranslate"><span class="pre">&quot;\n&quot;</span></code> in the map  to make <strong>line break</strong>. E.g. <code class="docutils literal notranslate"><span class="pre">{&quot;btn1&quot;,</span> <span class="pre">&quot;btn2&quot;,</span> <span class="pre">&quot;\n&quot;,</span> <span class="pre">&quot;btn3&quot;,</span> <span class="pre">&quot;&quot;}</span></code>. Each line’s buttons have their width calculated automatically.</p>
</div>
<div class="section" id="control-buttons">
<h3>Control buttons<a class="headerlink" href="#control-buttons" title="Permalink to this headline">¶</a></h3>
<p>The <strong>buttons width</strong> can be set relative to the other button in the same line with <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_btn_width(btnm,</span> <span class="pre">btn_id,</span> <span class="pre">width)</span></code>
E.g. in a line with two buttons: <em>btnA, width = 1</em> and <em>btnB, width = 2</em>, <em>btnA</em> will have 33 % width and <em>btnB</em> will have 66 % width. It’s similar to how the <a class="reference external" href="https://developer.mozilla.org/en-US/docs/Web/CSS/flex-grow"><code class="docutils literal notranslate"><span class="pre">flex-grow</span></code></a> property works in CSS.</p>
<p>In addition to width, each button can be customized with the following parameters:</p>
<ul class="simple">
<li><p><strong>LV_BTNM_CTRL_HIDDEN</strong> - make a button hidden (hidden buttons still take up space in the layout, they are just not visible or clickable)</p></li>
<li><p><strong>LV_BTNM_CTRL_NO_REPEAT</strong> - disable repeating when the button is long pressed</p></li>
<li><p><strong>LV_BTNM_CTRL_INACTIVE</strong> - make a button inactive</p></li>
<li><p><strong>LV_BTNM_CTRL_TGL_ENABLE</strong> - enable toggling of a button</p></li>
<li><p><strong>LV_BTNM_CTRL_TGL_STATE</strong> - set the toggle state</p></li>
<li><p><strong>LV_BTNM_CTRL_CLICK_TRIG</strong> - if 0, the button will react on press, if 1, will react on release</p></li>
</ul>
<p>The set or clear a button’s control attribute, use <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_btn_ctrl(btnm,</span> <span class="pre">btn_id,</span> <span class="pre">LV_BTNM_CTRL_...)</span></code> and <code class="docutils literal notranslate"><span class="pre">lv_btnm_clear_btn_ctrl(btnm,</span> <span class="pre">btn_id,</span> <span class="pre">LV_BTNM_CTRL_...)</span></code> respectively. More <code class="docutils literal notranslate"><span class="pre">LV_BTNM_CTRL_...</span></code> values can be <em>Or</em>ed</p>
<p>The set/clear the same control attribute for all buttons of a button matrix, use <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_btn_ctrl_all(btnm,</span> <span class="pre">btn_id,</span> <span class="pre">LV_BTNM_CTRL_...)</span></code> and <code class="docutils literal notranslate"><span class="pre">lv_btnm_clear_btn_ctrl_all(btnm,</span> <span class="pre">btn_id,</span> <span class="pre">LV_BTNM_CTRL_...)</span></code>.</p>
<p>The set a control map for a button matrix (similarly to the map for the text), use <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_ctrl_map(btnm,</span> <span class="pre">ctrl_map)</span></code>.
An element of <code class="docutils literal notranslate"><span class="pre">ctrl_map</span></code> should look like <code class="docutils literal notranslate"><span class="pre">ctrl_map[0]</span> <span class="pre">=</span> <span class="pre">width</span> <span class="pre">|</span> <span class="pre">LV_BTNM_CTRL_NO_REPEAT</span> <span class="pre">|</span>&#160; <span class="pre">LV_BTNM_CTRL_TGL_ENABLE</span></code>. The number of elements should be equal to the number of buttons (excluding newlines characters).</p>
</div>
<div class="section" id="one-toggle">
<h3>One toggle<a class="headerlink" href="#one-toggle" title="Permalink to this headline">¶</a></h3>
<p>The “One toggle” feature can be enabled with <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_one_toggle(btnm,</span> <span class="pre">true)</span></code> to allow only one button to be toggled at once.</p>
</div>
<div class="section" id="recolor">
<h3>Recolor<a class="headerlink" href="#recolor" title="Permalink to this headline">¶</a></h3>
<p>The <strong>texts</strong> on the button can be <strong>recolored</strong> similarly to the recolor feature for <a class="reference internal" href="label.html"><span class="doc">Label</span></a> object. To enable it, use <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_recolor(btnm,</span> <span class="pre">true)</span></code>. After that a button with <code class="docutils literal notranslate"><span class="pre">#FF0000</span> <span class="pre">Red#</span></code> text will be red.</p>
</div>
<div class="section" id="notes">
<h3>Notes<a class="headerlink" href="#notes" title="Permalink to this headline">¶</a></h3>
<p>The Button matrix object is very light weighted because the buttons are not created just virtually drawn on the fly.
This way, 1 button use only 8 extra bytes instead of the ~100-150 byte size of a normal <a class="reference internal" href="btn.html"><span class="doc">Button</span></a> object (plus the size of its container and a label for each button).</p>
<p>The disadvantage of this setup is that the ability to style individual buttons to be different from others is limited (aside from the toggling feature). If you require that ability, using individual buttons is very likely to be a better approach.</p>
</div>
</div>
<div class="section" id="styles">
<h2>Styles<a class="headerlink" href="#styles" title="Permalink to this headline">¶</a></h2>
<p>The Button matrix works with 6 styles: a background and 5 button styles for each state. You can set the styles with <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_style(btn,</span> <span class="pre">LV_BTNM_STYLE_...,</span> <span class="pre">&amp;style)</span></code>.
The background and the buttons use the <code class="docutils literal notranslate"><span class="pre">style.body</span></code> properties. The labels use the <code class="docutils literal notranslate"><span class="pre">style.text</span></code> properties of the button styles.</p>
<ul class="simple">
<li><p><strong>LV_BTNM_STYLE_BG</strong> - Background style. Uses all <em>style.body</em> properties including <em>padding</em> Default: <em>lv_style_pretty</em></p></li>
<li><p><strong>LV_BTNM_STYLE_BTN_REL</strong> - style of the released  buttons. Default: <em>lv_style_btn_rel</em></p></li>
<li><p><strong>LV_BTNM_STYLE_BTN_PR</strong> - style of the pressed buttons. Default: <em>lv_style_btn_pr</em></p></li>
<li><p><strong>LV_BTNM_STYLE_BTN_TGL_REL</strong> - style of the toggled released  buttons. Default: <em>lv_style_btn_tgl_rel</em></p></li>
<li><p><strong>LV_BTNM_STYLE_BTN_TGL_PR</strong> - style of the toggled pressed  buttons. Default: <em>lv_style_btn_tgl_pr</em></p></li>
<li><p><strong>LV_BTNM_STYLE_BTN_INA</strong> - style of the inactive  buttons. Default: <em>lv_style_btn_ina</em></p></li>
</ul>
</div>
<div class="section" id="events">
<h2>Events<a class="headerlink" href="#events" title="Permalink to this headline">¶</a></h2>
<p>Besides the <a class="reference external" href="/overview/events.html#generic-event">Generic events</a>, the following <a class="reference external" href="/overview/event.html#special-events">Special events</a> are sent by the button matrices:</p>
<ul class="simple">
<li><p><strong>LV_EVENT_VALUE_CHANGED</strong> - sent when the button is pressed/released or repeated after long press. The event data is set to the ID of the pressed/released button.</p></li>
</ul>
<p>Learn more about <a class="reference internal" href="../overview/event.html"><span class="doc">Events</span></a>.</p>
</div>
<div class="section" id="keys">
<h2>Keys<a class="headerlink" href="#keys" title="Permalink to this headline">¶</a></h2>
<p>The following <em>Keys</em> are processed by the Buttons:</p>
<ul class="simple">
<li><p><strong>LV_KEY_RIGHT/UP/LEFT/RIGHT</strong> - To navigate among the buttons to select one</p></li>
<li><p><strong>LV_KEY_ENTER</strong> - To press/release the selected button</p></li>
</ul>
<p>Learn more about <a class="reference internal" href="../overview/indev.html"><span class="doc">Keys</span></a>.</p>
</div>
<div class="section" id="example">
<h2>Example<a class="headerlink" href="#example" title="Permalink to this headline">¶</a></h2>
<div class="section" id="c">
<h3>C<a class="headerlink" href="#c" title="Permalink to this headline">¶</a></h3>
<div class="section" id="simple-button-matrix">
<h4>Simple Button matrix<a class="headerlink" href="#simple-button-matrix" title="Permalink to this headline">¶</a></h4>
<img alt="Simple Button matrix example in LittlevGL" src="../_images/lv_ex_btnm_1.gif" />
<div class="toggle docutils container">
<div class="header docutils container">
<p>code</p>
</div>
<div class="highlight-c notranslate"><div class="highlight"><pre><span></span><span class="cp">#include</span> <span class="cpf">&quot;lvgl/lvgl.h&quot;</span><span class="cp"></span>
<span class="cp">#include</span> <span class="cpf">&lt;stdio.h&gt;</span><span class="cp"></span>

<span class="k">static</span> <span class="kt">void</span> <span class="nf">event_handler</span><span class="p">(</span><span class="n">lv_obj_t</span> <span class="o">*</span> <span class="n">obj</span><span class="p">,</span> <span class="n">lv_event_t</span> <span class="n">event</span><span class="p">)</span>
<span class="p">{</span>
    <span class="k">if</span><span class="p">(</span><span class="n">event</span> <span class="o">==</span> <span class="n">LV_EVENT_VALUE_CHANGED</span><span class="p">)</span> <span class="p">{</span>
        <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span> <span class="n">txt</span> <span class="o">=</span> <span class="n">lv_btnm_get_active_btn_text</span><span class="p">(</span><span class="n">obj</span><span class="p">);</span>

        <span class="n">printf</span><span class="p">(</span><span class="s">&quot;%s was pressed</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span> <span class="n">txt</span><span class="p">);</span>
    <span class="p">}</span>
<span class="p">}</span>


<span class="k">static</span> <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span> <span class="n">btnm_map</span><span class="p">[]</span> <span class="o">=</span> <span class="p">{</span><span class="s">&quot;1&quot;</span><span class="p">,</span> <span class="s">&quot;2&quot;</span><span class="p">,</span> <span class="s">&quot;3&quot;</span><span class="p">,</span> <span class="s">&quot;4&quot;</span><span class="p">,</span> <span class="s">&quot;5&quot;</span><span class="p">,</span> <span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span>
                                  <span class="s">&quot;6&quot;</span><span class="p">,</span> <span class="s">&quot;7&quot;</span><span class="p">,</span> <span class="s">&quot;8&quot;</span><span class="p">,</span> <span class="s">&quot;9&quot;</span><span class="p">,</span> <span class="s">&quot;0&quot;</span><span class="p">,</span> <span class="s">&quot;</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span>
                                  <span class="s">&quot;Action1&quot;</span><span class="p">,</span> <span class="s">&quot;Action2&quot;</span><span class="p">,</span> <span class="s">&quot;&quot;</span><span class="p">};</span>

<span class="kt">void</span> <span class="nf">lv_ex_btnm_1</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span>
<span class="p">{</span>
    <span class="n">lv_obj_t</span> <span class="o">*</span> <span class="n">btnm1</span> <span class="o">=</span> <span class="n">lv_btnm_create</span><span class="p">(</span><span class="n">lv_scr_act</span><span class="p">(),</span> <span class="nb">NULL</span><span class="p">);</span>
    <span class="n">lv_btnm_set_map</span><span class="p">(</span><span class="n">btnm1</span><span class="p">,</span> <span class="n">btnm_map</span><span class="p">);</span>
    <span class="n">lv_btnm_set_btn_width</span><span class="p">(</span><span class="n">btnm1</span><span class="p">,</span> <span class="mi">10</span><span class="p">,</span> <span class="mi">2</span><span class="p">);</span>        <span class="cm">/*Make &quot;Action1&quot; twice as wide as &quot;Action2&quot;*/</span>
    <span class="n">lv_obj_align</span><span class="p">(</span><span class="n">btnm1</span><span class="p">,</span> <span class="nb">NULL</span><span class="p">,</span> <span class="n">LV_ALIGN_CENTER</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">);</span>
    <span class="n">lv_obj_set_event_cb</span><span class="p">(</span><span class="n">btnm1</span><span class="p">,</span> <span class="n">event_handler</span><span class="p">);</span>
<span class="p">}</span>
</pre></div>
</div>
</div>
</div>
</div>
<div class="section" id="micropython">
<h3>MicroPython<a class="headerlink" href="#micropython" title="Permalink to this headline">¶</a></h3>
<div class="section" id="id1">
<h4>Simple Button matrix<a class="headerlink" href="#id1" title="Permalink to this headline">¶</a></h4>
<img alt="Simple Button matrix example in LittlevGL with MicroPython" src="../_images/lv_ex_btnm_1.gif" />
<div class="toggle docutils container">
<div class="header docutils container">
<p>code</p>
</div>
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="k">def</span> <span class="nf">event_handler</span><span class="p">(</span><span class="n">obj</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
    <span class="k">if</span> <span class="n">event</span> <span class="o">==</span> <span class="n">lv</span><span class="o">.</span><span class="n">EVENT</span><span class="o">.</span><span class="n">VALUE_CHANGED</span><span class="p">:</span>
        <span class="n">txt</span> <span class="o">=</span> <span class="n">obj</span><span class="o">.</span><span class="n">get_active_btn_text</span><span class="p">()</span>
        <span class="k">print</span><span class="p">(</span><span class="s2">&quot;</span><span class="si">%s</span><span class="s2"> was pressed&quot;</span> <span class="o">%</span> <span class="n">txt</span><span class="p">)</span>

<span class="n">btnm_map</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;1&quot;</span><span class="p">,</span> <span class="s2">&quot;2&quot;</span><span class="p">,</span> <span class="s2">&quot;3&quot;</span><span class="p">,</span> <span class="s2">&quot;4&quot;</span><span class="p">,</span> <span class="s2">&quot;5&quot;</span><span class="p">,</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">,</span>
            <span class="s2">&quot;6&quot;</span><span class="p">,</span> <span class="s2">&quot;7&quot;</span><span class="p">,</span> <span class="s2">&quot;8&quot;</span><span class="p">,</span> <span class="s2">&quot;9&quot;</span><span class="p">,</span> <span class="s2">&quot;0&quot;</span><span class="p">,</span> <span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">,</span>
            <span class="s2">&quot;Action1&quot;</span><span class="p">,</span> <span class="s2">&quot;Action2&quot;</span><span class="p">,</span> <span class="s2">&quot;&quot;</span><span class="p">]</span>

<span class="n">btnm1</span> <span class="o">=</span> <span class="n">lv</span><span class="o">.</span><span class="n">btnm</span><span class="p">(</span><span class="n">lv</span><span class="o">.</span><span class="n">scr_act</span><span class="p">())</span>
<span class="n">btnm1</span><span class="o">.</span><span class="n">set_map</span><span class="p">(</span><span class="n">btnm_map</span><span class="p">)</span>
<span class="n">btnm1</span><span class="o">.</span><span class="n">set_btn_width</span><span class="p">(</span><span class="mi">10</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>        <span class="c1"># Make &quot;Action1&quot; twice as wide as &quot;Action2&quot;</span>
<span class="n">btnm1</span><span class="o">.</span><span class="n">align</span><span class="p">(</span><span class="bp">None</span><span class="p">,</span> <span class="n">lv</span><span class="o">.</span><span class="n">ALIGN</span><span class="o">.</span><span class="n">CENTER</span><span class="p">,</span> <span class="mi">0</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
<span class="n">btnm1</span><span class="o">.</span><span class="n">set_event_cb</span><span class="p">(</span><span class="n">event_handler</span><span class="p">)</span>
</pre></div>
</div>
</div>
</div>
</div>
</div>
<div class="section" id="api">
<h2>API<a class="headerlink" href="#api" title="Permalink to this headline">¶</a></h2>
<div class="breathe-sectiondef docutils container">
<p class="breathe-sectiondef-title rubric">Typedefs</p>
<dl class="cpp type">
<dt id="_CPPv414lv_btnm_ctrl_t">
<span id="_CPPv314lv_btnm_ctrl_t"></span><span id="_CPPv214lv_btnm_ctrl_t"></span><span id="lv_btnm_ctrl_t"></span><span class="target" id="lv__btnm_8h_1a5ca13388155d669858d15ddddd9bc886"></span><em class="property">typedef </em>uint16_t <code class="sig-name descname">lv_btnm_ctrl_t</code><a class="headerlink" href="#_CPPv414lv_btnm_ctrl_t" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp type">
<dt id="_CPPv415lv_btnm_style_t">
<span id="_CPPv315lv_btnm_style_t"></span><span id="_CPPv215lv_btnm_style_t"></span><span id="lv_btnm_style_t"></span><span class="target" id="lv__btnm_8h_1a8cbd5d07da0f11531cb9b914c1c68297"></span><em class="property">typedef </em>uint8_t <code class="sig-name descname">lv_btnm_style_t</code><a class="headerlink" href="#_CPPv415lv_btnm_style_t" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

</div>
<div class="breathe-sectiondef docutils container">
<p class="breathe-sectiondef-title rubric">Enums</p>
<dl class="cpp enum">
<dt id="_CPPv4Ut2_44">
<span id="_CPPv3Ut2_44"></span><span class="target" id="lv__btnm_8h_1a157d5577a5b2f5986037d0d09c7dc77d"></span><em class="property">enum </em><strong>[anonymous]</strong><a class="headerlink" href="#_CPPv4Ut2_44" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Type to store button control bits (disabled, hidden etc.) </p>
<p><em>Values:</em></p>
<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4419LV_BTNM_CTRL_HIDDENE">
<span id="_CPPv3NUt2_4419LV_BTNM_CTRL_HIDDENE"></span><span class="target" id="lv__btnm_8h_1a157d5577a5b2f5986037d0d09c7dc77da6325054755490ad84e4085bd52ba650c"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_CTRL_HIDDEN</code> = 0x0008<a class="headerlink" href="#_CPPv4NUt2_4419LV_BTNM_CTRL_HIDDENE" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Button hidden </p>
</dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4422LV_BTNM_CTRL_NO_REPEATE">
<span id="_CPPv3NUt2_4422LV_BTNM_CTRL_NO_REPEATE"></span><span class="target" id="lv__btnm_8h_1a157d5577a5b2f5986037d0d09c7dc77da41e045fb4266537b403626e7e93d3e2e"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_CTRL_NO_REPEAT</code> = 0x0010<a class="headerlink" href="#_CPPv4NUt2_4422LV_BTNM_CTRL_NO_REPEATE" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Do not repeat press this button. </p>
</dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4421LV_BTNM_CTRL_INACTIVEE">
<span id="_CPPv3NUt2_4421LV_BTNM_CTRL_INACTIVEE"></span><span class="target" id="lv__btnm_8h_1a157d5577a5b2f5986037d0d09c7dc77daed085eadd61feb31805502c2c88ac366"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_CTRL_INACTIVE</code> = 0x0020<a class="headerlink" href="#_CPPv4NUt2_4421LV_BTNM_CTRL_INACTIVEE" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Disable this button. </p>
</dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4423LV_BTNM_CTRL_TGL_ENABLEE">
<span id="_CPPv3NUt2_4423LV_BTNM_CTRL_TGL_ENABLEE"></span><span class="target" id="lv__btnm_8h_1a157d5577a5b2f5986037d0d09c7dc77daa15362b72181b6976ada6665413595df"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_CTRL_TGL_ENABLE</code> = 0x0040<a class="headerlink" href="#_CPPv4NUt2_4423LV_BTNM_CTRL_TGL_ENABLEE" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Button <em>can</em> be toggled. </p>
</dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4422LV_BTNM_CTRL_TGL_STATEE">
<span id="_CPPv3NUt2_4422LV_BTNM_CTRL_TGL_STATEE"></span><span class="target" id="lv__btnm_8h_1a157d5577a5b2f5986037d0d09c7dc77da16a69231bc886f3e2a69bb573f11721e"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_CTRL_TGL_STATE</code> = 0x0080<a class="headerlink" href="#_CPPv4NUt2_4422LV_BTNM_CTRL_TGL_STATEE" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Button is currently toggled (e.g. checked). </p>
</dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4423LV_BTNM_CTRL_CLICK_TRIGE">
<span id="_CPPv3NUt2_4423LV_BTNM_CTRL_CLICK_TRIGE"></span><span class="target" id="lv__btnm_8h_1a157d5577a5b2f5986037d0d09c7dc77da0decec696cb3a692581900ddd7c2fae8"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_CTRL_CLICK_TRIG</code> = 0x0100<a class="headerlink" href="#_CPPv4NUt2_4423LV_BTNM_CTRL_CLICK_TRIGE" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>1: Send LV_EVENT_SELECTED on CLICK, 0: Send LV_EVENT_SELECTED on PRESS </p>
</dd></dl>

</dd></dl>

<dl class="cpp enum">
<dt id="_CPPv4Ut2_45">
<span id="_CPPv3Ut2_45"></span><span class="target" id="lv__btnm_8h_1a1fb9092bcdeada2d206bdc74afbbe122"></span><em class="property">enum </em><strong>[anonymous]</strong><a class="headerlink" href="#_CPPv4Ut2_45" title="Permalink to this definition">¶</a><br /></dt>
<dd><p><em>Values:</em></p>
<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4516LV_BTNM_STYLE_BGE">
<span id="_CPPv3NUt2_4516LV_BTNM_STYLE_BGE"></span><span class="target" id="lv__btnm_8h_1a1fb9092bcdeada2d206bdc74afbbe122a450cf0619f45a4f195f15ac4ab3934af"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_STYLE_BG</code><a class="headerlink" href="#_CPPv4NUt2_4516LV_BTNM_STYLE_BGE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4521LV_BTNM_STYLE_BTN_RELE">
<span id="_CPPv3NUt2_4521LV_BTNM_STYLE_BTN_RELE"></span><span class="target" id="lv__btnm_8h_1a1fb9092bcdeada2d206bdc74afbbe122a1cc297cfc08f2c14335a3efda2e29a0f"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_STYLE_BTN_REL</code><a class="headerlink" href="#_CPPv4NUt2_4521LV_BTNM_STYLE_BTN_RELE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4520LV_BTNM_STYLE_BTN_PRE">
<span id="_CPPv3NUt2_4520LV_BTNM_STYLE_BTN_PRE"></span><span class="target" id="lv__btnm_8h_1a1fb9092bcdeada2d206bdc74afbbe122adfff67339b9d45cfb5038daedafa315f"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_STYLE_BTN_PR</code><a class="headerlink" href="#_CPPv4NUt2_4520LV_BTNM_STYLE_BTN_PRE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4525LV_BTNM_STYLE_BTN_TGL_RELE">
<span id="_CPPv3NUt2_4525LV_BTNM_STYLE_BTN_TGL_RELE"></span><span class="target" id="lv__btnm_8h_1a1fb9092bcdeada2d206bdc74afbbe122a69eab95b41edf7f20863cfb28d5628b6"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_STYLE_BTN_TGL_REL</code><a class="headerlink" href="#_CPPv4NUt2_4525LV_BTNM_STYLE_BTN_TGL_RELE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4524LV_BTNM_STYLE_BTN_TGL_PRE">
<span id="_CPPv3NUt2_4524LV_BTNM_STYLE_BTN_TGL_PRE"></span><span class="target" id="lv__btnm_8h_1a1fb9092bcdeada2d206bdc74afbbe122a6de231d8228f156307cfbae49f5a0822"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_STYLE_BTN_TGL_PR</code><a class="headerlink" href="#_CPPv4NUt2_4524LV_BTNM_STYLE_BTN_TGL_PRE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp enumerator">
<dt id="_CPPv4NUt2_4521LV_BTNM_STYLE_BTN_INAE">
<span id="_CPPv3NUt2_4521LV_BTNM_STYLE_BTN_INAE"></span><span class="target" id="lv__btnm_8h_1a1fb9092bcdeada2d206bdc74afbbe122acee309a1f788b8be553705be2032f525"></span><em class="property">enumerator </em><code class="sig-name descname">LV_BTNM_STYLE_BTN_INA</code><a class="headerlink" href="#_CPPv4NUt2_4521LV_BTNM_STYLE_BTN_INAE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

</dd></dl>

</div>
<div class="breathe-sectiondef docutils container">
<p class="breathe-sectiondef-title rubric">Functions</p>
<dl class="cpp function">
<dt id="_CPPv419LV_EXPORT_CONST_INT16LV_BTNM_BTN_NONE">
<span id="_CPPv319LV_EXPORT_CONST_INT16LV_BTNM_BTN_NONE"></span><span id="_CPPv219LV_EXPORT_CONST_INT16LV_BTNM_BTN_NONE"></span><span id="LV_EXPORT_CONST_INT__LV_BTNM_BTN_NONE"></span><span class="target" id="lv__btnm_8h_1a4322ca6a98c088651b10f60aec681321"></span><code class="sig-name descname">LV_EXPORT_CONST_INT</code><span class="sig-paren">(</span>LV_BTNM_BTN_NONE<span class="sig-paren">)</span><a class="headerlink" href="#_CPPv419LV_EXPORT_CONST_INT16LV_BTNM_BTN_NONE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp function">
<dt id="_CPPv414lv_btnm_createP8lv_obj_tPK8lv_obj_t">
<span id="_CPPv314lv_btnm_createP8lv_obj_tPK8lv_obj_t"></span><span id="_CPPv214lv_btnm_createP8lv_obj_tPK8lv_obj_t"></span><span id="lv_btnm_create__lv_obj_tP.lv_obj_tCP"></span><span class="target" id="lv__btnm_8h_1a0ec99938def76fcc6fc3930f39e0a670"></span><a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<code class="sig-name descname">lv_btnm_create</code><span class="sig-paren">(</span><a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>par</em>, <em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>copy</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv414lv_btnm_createP8lv_obj_tPK8lv_obj_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Create a button matrix objects <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>pointer to the created button matrix </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">par</span></code>: pointer to an object, it will be the parent of the new button matrix </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">copy</span></code>: pointer to a button matrix object, if not NULL then the new object will be copied from it </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv415lv_btnm_set_mapPK8lv_obj_tA_PKc">
<span id="_CPPv315lv_btnm_set_mapPK8lv_obj_tA_PKc"></span><span id="_CPPv215lv_btnm_set_mapPK8lv_obj_tA_PKc"></span><span id="lv_btnm_set_map__lv_obj_tCP.cCPA"></span><span class="target" id="lv__btnm_8h_1aec4554ea1f5f349fb4940962fbfd96ca"></span>void <code class="sig-name descname">lv_btnm_set_map</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, <em class="property">const</em> char *<em>map</em>[]<span class="sig-paren">)</span><a class="headerlink" href="#_CPPv415lv_btnm_set_mapPK8lv_obj_tA_PKc" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Set a new map. Buttons will be created/deleted according to the map. The button matrix keeps a reference to the map and so the string array must not be deallocated during the life of the matrix. <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to a button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">map</span></code>: pointer a string array. The last string has to be: “”. Use “\n” to make a line break. </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv420lv_btnm_set_ctrl_mapPK8lv_obj_tA_K14lv_btnm_ctrl_t">
<span id="_CPPv320lv_btnm_set_ctrl_mapPK8lv_obj_tA_K14lv_btnm_ctrl_t"></span><span id="_CPPv220lv_btnm_set_ctrl_mapPK8lv_obj_tA_K14lv_btnm_ctrl_t"></span><span id="lv_btnm_set_ctrl_map__lv_obj_tCP.lv_btnm_ctrl_tCA"></span><span class="target" id="lv__btnm_8h_1ab23a2e9c00d4e30922674915b6911961"></span>void <code class="sig-name descname">lv_btnm_set_ctrl_map</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, <em class="property">const</em> <a class="reference internal" href="#_CPPv414lv_btnm_ctrl_t" title="lv_btnm_ctrl_t">lv_btnm_ctrl_t</a> <em>ctrl_map</em>[]<span class="sig-paren">)</span><a class="headerlink" href="#_CPPv420lv_btnm_set_ctrl_mapPK8lv_obj_tA_K14lv_btnm_ctrl_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Set the button control map (hidden, disabled etc.) for a button matrix. The control map array will be copied and so may be deallocated after this function returns. <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to a button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">ctrl_map</span></code>: pointer to an array of <code class="docutils literal notranslate"><span class="pre">lv_btn_ctrl_t</span></code> control bytes. The length of the array and position of the elements must match the number and order of the individual buttons (i.e. excludes newline entries). An element of the map should look like e.g.: <code class="docutils literal notranslate"><span class="pre">ctrl_map[0]</span> <span class="pre">=</span> <span class="pre">width</span> <span class="pre">|</span> <span class="pre">LV_BTNM_CTRL_NO_REPEAT</span> <span class="pre">|</span> <span class="pre">LV_BTNM_CTRL_TGL_ENABLE</span></code> </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv419lv_btnm_set_pressedPK8lv_obj_t8uint16_t">
<span id="_CPPv319lv_btnm_set_pressedPK8lv_obj_t8uint16_t"></span><span id="_CPPv219lv_btnm_set_pressedPK8lv_obj_t8uint16_t"></span><span id="lv_btnm_set_pressed__lv_obj_tCP.uint16_t"></span><span class="target" id="lv__btnm_8h_1aead167ad0009cf37e4427a8b008c79ed"></span>void <code class="sig-name descname">lv_btnm_set_pressed</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, uint16_t <em>id</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv419lv_btnm_set_pressedPK8lv_obj_t8uint16_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Set the pressed button i.e. visually highlight it. Mainly used a when the btnm is in a group to show the selected button <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">id</span></code>: index of the currently pressed button (<code class="docutils literal notranslate"><span class="pre">LV_BTNM_BTN_NONE</span></code> to unpress) </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv417lv_btnm_set_styleP8lv_obj_t15lv_btnm_style_tPK10lv_style_t">
<span id="_CPPv317lv_btnm_set_styleP8lv_obj_t15lv_btnm_style_tPK10lv_style_t"></span><span id="_CPPv217lv_btnm_set_styleP8lv_obj_t15lv_btnm_style_tPK10lv_style_t"></span><span id="lv_btnm_set_style__lv_obj_tP.lv_btnm_style_t.lv_style_tCP"></span><span class="target" id="lv__btnm_8h_1a34087a880e2961906f9b157a9a70e205"></span>void <code class="sig-name descname">lv_btnm_set_style</code><span class="sig-paren">(</span><a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, <a class="reference internal" href="#_CPPv415lv_btnm_style_t" title="lv_btnm_style_t">lv_btnm_style_t</a> <em>type</em>, <em class="property">const</em> lv_style_t *<em>style</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv417lv_btnm_set_styleP8lv_obj_t15lv_btnm_style_tPK10lv_style_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Set a style of a button matrix <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to a button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">type</span></code>: which style should be set </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">style</span></code>: pointer to a style </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv419lv_btnm_set_recolorPK8lv_obj_tb">
<span id="_CPPv319lv_btnm_set_recolorPK8lv_obj_tb"></span><span id="_CPPv219lv_btnm_set_recolorPK8lv_obj_tb"></span><span id="lv_btnm_set_recolor__lv_obj_tCP.b"></span><span class="target" id="lv__btnm_8h_1abd93534e13a034300d265d338a797dab"></span>void <code class="sig-name descname">lv_btnm_set_recolor</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, bool <em>en</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv419lv_btnm_set_recolorPK8lv_obj_tb" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Enable recoloring of button’s texts <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">en</span></code>: true: enable recoloring; false: disable </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv420lv_btnm_set_btn_ctrlPK8lv_obj_t8uint16_t14lv_btnm_ctrl_t">
<span id="_CPPv320lv_btnm_set_btn_ctrlPK8lv_obj_t8uint16_t14lv_btnm_ctrl_t"></span><span id="_CPPv220lv_btnm_set_btn_ctrlPK8lv_obj_t8uint16_t14lv_btnm_ctrl_t"></span><span id="lv_btnm_set_btn_ctrl__lv_obj_tCP.uint16_t.lv_btnm_ctrl_t"></span><span class="target" id="lv__btnm_8h_1ae21cc7a66d0ffd2b3ee4936e3549c7ab"></span>void <code class="sig-name descname">lv_btnm_set_btn_ctrl</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, uint16_t <em>btn_id</em>, <a class="reference internal" href="#_CPPv414lv_btnm_ctrl_t" title="lv_btnm_ctrl_t">lv_btnm_ctrl_t</a> <em>ctrl</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv420lv_btnm_set_btn_ctrlPK8lv_obj_t8uint16_t14lv_btnm_ctrl_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Set the attributes of a button of the button matrix <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">btn_id</span></code>: 0 based index of the button to modify. (Not counting new lines) </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv422lv_btnm_clear_btn_ctrlPK8lv_obj_t8uint16_t14lv_btnm_ctrl_t">
<span id="_CPPv322lv_btnm_clear_btn_ctrlPK8lv_obj_t8uint16_t14lv_btnm_ctrl_t"></span><span id="_CPPv222lv_btnm_clear_btn_ctrlPK8lv_obj_t8uint16_t14lv_btnm_ctrl_t"></span><span id="lv_btnm_clear_btn_ctrl__lv_obj_tCP.uint16_t.lv_btnm_ctrl_t"></span><span class="target" id="lv__btnm_8h_1a02d0a210cf0565d103725b204407ef94"></span>void <code class="sig-name descname">lv_btnm_clear_btn_ctrl</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, uint16_t <em>btn_id</em>, <a class="reference internal" href="#_CPPv414lv_btnm_ctrl_t" title="lv_btnm_ctrl_t">lv_btnm_ctrl_t</a> <em>ctrl</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv422lv_btnm_clear_btn_ctrlPK8lv_obj_t8uint16_t14lv_btnm_ctrl_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Clear the attributes of a button of the button matrix <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">btn_id</span></code>: 0 based index of the button to modify. (Not counting new lines) </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv424lv_btnm_set_btn_ctrl_allP8lv_obj_t14lv_btnm_ctrl_t">
<span id="_CPPv324lv_btnm_set_btn_ctrl_allP8lv_obj_t14lv_btnm_ctrl_t"></span><span id="_CPPv224lv_btnm_set_btn_ctrl_allP8lv_obj_t14lv_btnm_ctrl_t"></span><span id="lv_btnm_set_btn_ctrl_all__lv_obj_tP.lv_btnm_ctrl_t"></span><span class="target" id="lv__btnm_8h_1a253ab5e364ff7b9e2c2e6523a21c231f"></span>void <code class="sig-name descname">lv_btnm_set_btn_ctrl_all</code><span class="sig-paren">(</span><a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, <a class="reference internal" href="#_CPPv414lv_btnm_ctrl_t" title="lv_btnm_ctrl_t">lv_btnm_ctrl_t</a> <em>ctrl</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv424lv_btnm_set_btn_ctrl_allP8lv_obj_t14lv_btnm_ctrl_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Set the attributes of all buttons of a button matrix <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to a button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">ctrl</span></code>: attribute(s) to set from <code class="docutils literal notranslate"><span class="pre">lv_btnm_ctrl_t</span></code>. Values can be ORed. </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv426lv_btnm_clear_btn_ctrl_allP8lv_obj_t14lv_btnm_ctrl_t">
<span id="_CPPv326lv_btnm_clear_btn_ctrl_allP8lv_obj_t14lv_btnm_ctrl_t"></span><span id="_CPPv226lv_btnm_clear_btn_ctrl_allP8lv_obj_t14lv_btnm_ctrl_t"></span><span id="lv_btnm_clear_btn_ctrl_all__lv_obj_tP.lv_btnm_ctrl_t"></span><span class="target" id="lv__btnm_8h_1acaf56d04d312be5f1cac1cf0acd5bc78"></span>void <code class="sig-name descname">lv_btnm_clear_btn_ctrl_all</code><span class="sig-paren">(</span><a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, <a class="reference internal" href="#_CPPv414lv_btnm_ctrl_t" title="lv_btnm_ctrl_t">lv_btnm_ctrl_t</a> <em>ctrl</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv426lv_btnm_clear_btn_ctrl_allP8lv_obj_t14lv_btnm_ctrl_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Clear the attributes of all buttons of a button matrix <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to a button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">ctrl</span></code>: attribute(s) to set from <code class="docutils literal notranslate"><span class="pre">lv_btnm_ctrl_t</span></code>. Values can be ORed. </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">en</span></code>: true: set the attributes; false: clear the attributes </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv421lv_btnm_set_btn_widthPK8lv_obj_t8uint16_t7uint8_t">
<span id="_CPPv321lv_btnm_set_btn_widthPK8lv_obj_t8uint16_t7uint8_t"></span><span id="_CPPv221lv_btnm_set_btn_widthPK8lv_obj_t8uint16_t7uint8_t"></span><span id="lv_btnm_set_btn_width__lv_obj_tCP.uint16_t.uint8_t"></span><span class="target" id="lv__btnm_8h_1a72abdc1b01e584bad5fa9edf80a0ecff"></span>void <code class="sig-name descname">lv_btnm_set_btn_width</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, uint16_t <em>btn_id</em>, uint8_t <em>width</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv421lv_btnm_set_btn_widthPK8lv_obj_t8uint16_t7uint8_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Set a single buttons relative width. This method will cause the matrix be regenerated and is a relatively expensive operation. It is recommended that initial width be specified using <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_ctrl_map</span></code> and this method only be used for dynamic changes. <dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">btn_id</span></code>: 0 based index of the button to modify. </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">width</span></code>: Relative width compared to the buttons in the same row. [1..7] </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv422lv_btnm_set_one_toggleP8lv_obj_tb">
<span id="_CPPv322lv_btnm_set_one_toggleP8lv_obj_tb"></span><span id="_CPPv222lv_btnm_set_one_toggleP8lv_obj_tb"></span><span id="lv_btnm_set_one_toggle__lv_obj_tP.b"></span><span class="target" id="lv__btnm_8h_1ad875619d4dea16a320da0abeb86f799e"></span>void <code class="sig-name descname">lv_btnm_set_one_toggle</code><span class="sig-paren">(</span><a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, bool <em>one_toggle</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv422lv_btnm_set_one_toggleP8lv_obj_tb" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Make the button matrix like a selector widget (only one button may be toggled at a time).</p>
<p>Toggling must be enabled on the buttons you want to be selected with <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_ctrl</span></code> or <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_btn_ctrl_all</span></code>.</p>
<p><dl class="simple">
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: Button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">one_toggle</span></code>: Whether “one toggle” mode is enabled </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv421lv_btnm_get_map_arrayPK8lv_obj_t">
<span id="_CPPv321lv_btnm_get_map_arrayPK8lv_obj_t"></span><span id="_CPPv221lv_btnm_get_map_arrayPK8lv_obj_t"></span><span id="lv_btnm_get_map_array__lv_obj_tCP"></span><span class="target" id="lv__btnm_8h_1a42b8bfe716e787afa46fd89ca7bacd89"></span><em class="property">const</em> char **<code class="sig-name descname">lv_btnm_get_map_array</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv421lv_btnm_get_map_arrayPK8lv_obj_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Get the current map of a button matrix <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>the current map </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to a button matrix object </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv419lv_btnm_get_recolorPK8lv_obj_t">
<span id="_CPPv319lv_btnm_get_recolorPK8lv_obj_t"></span><span id="_CPPv219lv_btnm_get_recolorPK8lv_obj_t"></span><span id="lv_btnm_get_recolor__lv_obj_tCP"></span><span class="target" id="lv__btnm_8h_1ae801c03efd7beb3606729e47f349eede"></span>bool <code class="sig-name descname">lv_btnm_get_recolor</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv419lv_btnm_get_recolorPK8lv_obj_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Check whether the button’s text can use recolor or not <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>true: text recolor enable; false: disabled </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv422lv_btnm_get_active_btnPK8lv_obj_t">
<span id="_CPPv322lv_btnm_get_active_btnPK8lv_obj_t"></span><span id="_CPPv222lv_btnm_get_active_btnPK8lv_obj_t"></span><span id="lv_btnm_get_active_btn__lv_obj_tCP"></span><span class="target" id="lv__btnm_8h_1a428ad43259da835405bd4301277ddd03"></span>uint16_t <code class="sig-name descname">lv_btnm_get_active_btn</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv422lv_btnm_get_active_btnPK8lv_obj_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Get the index of the lastly “activated” button by the user (pressed, released etc) Useful in the the <code class="docutils literal notranslate"><span class="pre">event_cb</span></code> to get the text of the button, check if hidden etc. <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>index of the last released button (LV_BTNM_BTN_NONE: if unset) </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv427lv_btnm_get_active_btn_textPK8lv_obj_t">
<span id="_CPPv327lv_btnm_get_active_btn_textPK8lv_obj_t"></span><span id="_CPPv227lv_btnm_get_active_btn_textPK8lv_obj_t"></span><span id="lv_btnm_get_active_btn_text__lv_obj_tCP"></span><span class="target" id="lv__btnm_8h_1a50df9e50ae0d8e4ae1a61a91f6730eb0"></span><em class="property">const</em> char *<code class="sig-name descname">lv_btnm_get_active_btn_text</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv427lv_btnm_get_active_btn_textPK8lv_obj_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Get the text of the lastly “activated” button by the user (pressed, released etc) Useful in the the <code class="docutils literal notranslate"><span class="pre">event_cb</span></code> <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>text of the last released button (NULL: if unset) </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv423lv_btnm_get_pressed_btnPK8lv_obj_t">
<span id="_CPPv323lv_btnm_get_pressed_btnPK8lv_obj_t"></span><span id="_CPPv223lv_btnm_get_pressed_btnPK8lv_obj_t"></span><span id="lv_btnm_get_pressed_btn__lv_obj_tCP"></span><span class="target" id="lv__btnm_8h_1a1152df53100d27dbee4395b42f15a2f0"></span>uint16_t <code class="sig-name descname">lv_btnm_get_pressed_btn</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv423lv_btnm_get_pressed_btnPK8lv_obj_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Get the pressed button’s index. The button be really pressed by the user or manually set to pressed with <code class="docutils literal notranslate"><span class="pre">lv_btnm_set_pressed</span></code> <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>index of the pressed button (LV_BTNM_BTN_NONE: if unset) </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv420lv_btnm_get_btn_textPK8lv_obj_t8uint16_t">
<span id="_CPPv320lv_btnm_get_btn_textPK8lv_obj_t8uint16_t"></span><span id="_CPPv220lv_btnm_get_btn_textPK8lv_obj_t8uint16_t"></span><span id="lv_btnm_get_btn_text__lv_obj_tCP.uint16_t"></span><span class="target" id="lv__btnm_8h_1a5adadb5024d6d28d34cbe8d35113ab92"></span><em class="property">const</em> char *<code class="sig-name descname">lv_btnm_get_btn_text</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, uint16_t <em>btn_id</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv420lv_btnm_get_btn_textPK8lv_obj_t8uint16_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Get the button’s text <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>text of btn_index` button </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">btn_id</span></code>: the index a button not counting new line characters. (The return value of lv_btnm_get_pressed/released) </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv420lv_btnm_get_btn_ctrlP8lv_obj_t8uint16_t14lv_btnm_ctrl_t">
<span id="_CPPv320lv_btnm_get_btn_ctrlP8lv_obj_t8uint16_t14lv_btnm_ctrl_t"></span><span id="_CPPv220lv_btnm_get_btn_ctrlP8lv_obj_t8uint16_t14lv_btnm_ctrl_t"></span><span id="lv_btnm_get_btn_ctrl__lv_obj_tP.uint16_t.lv_btnm_ctrl_t"></span><span class="target" id="lv__btnm_8h_1a9dc41a4bcec3c210548cbfbe3a1f4706"></span>bool <code class="sig-name descname">lv_btnm_get_btn_ctrl</code><span class="sig-paren">(</span><a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, uint16_t <em>btn_id</em>, <a class="reference internal" href="#_CPPv414lv_btnm_ctrl_t" title="lv_btnm_ctrl_t">lv_btnm_ctrl_t</a> <em>ctrl</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv420lv_btnm_get_btn_ctrlP8lv_obj_t8uint16_t14lv_btnm_ctrl_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Get the whether a control value is enabled or disabled for button of a button matrix <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>true: long press repeat is disabled; false: long press repeat enabled </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to a button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">btn_id</span></code>: the index a button not counting new line characters. (E.g. the return value of lv_btnm_get_pressed/released) </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">ctrl</span></code>: control values to check (ORed value can be used) </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv417lv_btnm_get_stylePK8lv_obj_t15lv_btnm_style_t">
<span id="_CPPv317lv_btnm_get_stylePK8lv_obj_t15lv_btnm_style_t"></span><span id="_CPPv217lv_btnm_get_stylePK8lv_obj_t15lv_btnm_style_t"></span><span id="lv_btnm_get_style__lv_obj_tCP.lv_btnm_style_t"></span><span class="target" id="lv__btnm_8h_1a16446edadc6e4480269fdf651297571e"></span><em class="property">const</em> lv_style_t *<code class="sig-name descname">lv_btnm_get_style</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em>, <a class="reference internal" href="#_CPPv415lv_btnm_style_t" title="lv_btnm_style_t">lv_btnm_style_t</a> <em>type</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv417lv_btnm_get_stylePK8lv_obj_t15lv_btnm_style_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Get a style of a button matrix <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>style pointer to a style </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: pointer to a button matrix object </p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">type</span></code>: which style should be get </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

<dl class="cpp function">
<dt id="_CPPv422lv_btnm_get_one_togglePK8lv_obj_t">
<span id="_CPPv322lv_btnm_get_one_togglePK8lv_obj_t"></span><span id="_CPPv222lv_btnm_get_one_togglePK8lv_obj_t"></span><span id="lv_btnm_get_one_toggle__lv_obj_tCP"></span><span class="target" id="lv__btnm_8h_1a2f0ff3e680b705ff757345bf15bea6bb"></span>bool <code class="sig-name descname">lv_btnm_get_one_toggle</code><span class="sig-paren">(</span><em class="property">const</em> <a class="reference internal" href="obj.html#_CPPv48lv_obj_t" title="lv_obj_t">lv_obj_t</a> *<em>btnm</em><span class="sig-paren">)</span><a class="headerlink" href="#_CPPv422lv_btnm_get_one_togglePK8lv_obj_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><p>Find whether “one toggle” mode is enabled. <dl class="simple">
<dt><strong>Return</strong></dt><dd><p>whether “one toggle” mode is enabled </p>
</dd>
<dt><strong>Parameters</strong></dt><dd><ul class="breatheparameterlist simple">
<li><p><code class="docutils literal notranslate"><span class="pre">btnm</span></code>: Button matrix object </p></li>
</ul>
</dd>
</dl>
</p>
</dd></dl>

</div>
<dl class="cpp struct">
<dt id="_CPPv413lv_btnm_ext_t">
<span id="_CPPv313lv_btnm_ext_t"></span><span id="_CPPv213lv_btnm_ext_t"></span><span id="lv_btnm_ext_t"></span><span class="target" id="structlv__btnm__ext__t"></span><em class="property">struct </em><code class="sig-name descname">lv_btnm_ext_t</code><a class="headerlink" href="#_CPPv413lv_btnm_ext_t" title="Permalink to this definition">¶</a><br /></dt>
<dd><div class="breathe-sectiondef docutils container">
<p class="breathe-sectiondef-title rubric">Public Members</p>
<dl class="cpp var">
<dt id="_CPPv4N13lv_btnm_ext_t5map_pE">
<span id="_CPPv3N13lv_btnm_ext_t5map_pE"></span><span id="_CPPv2N13lv_btnm_ext_t5map_pE"></span><span id="lv_btnm_ext_t::map_p__cCPP"></span><span class="target" id="structlv__btnm__ext__t_1a7cbdc929c41428857d685677f3548edc"></span><em class="property">const</em> char **<code class="sig-name descname">map_p</code><a class="headerlink" href="#_CPPv4N13lv_btnm_ext_t5map_pE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp var">
<dt id="_CPPv4N13lv_btnm_ext_t12button_areasE">
<span id="_CPPv3N13lv_btnm_ext_t12button_areasE"></span><span id="_CPPv2N13lv_btnm_ext_t12button_areasE"></span><span id="lv_btnm_ext_t::button_areas__lv_area_tP"></span><span class="target" id="structlv__btnm__ext__t_1ad218a320077555f752d3fcc2f236d70a"></span>lv_area_t *<code class="sig-name descname">button_areas</code><a class="headerlink" href="#_CPPv4N13lv_btnm_ext_t12button_areasE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp var">
<dt id="_CPPv4N13lv_btnm_ext_t9ctrl_bitsE">
<span id="_CPPv3N13lv_btnm_ext_t9ctrl_bitsE"></span><span id="_CPPv2N13lv_btnm_ext_t9ctrl_bitsE"></span><span id="lv_btnm_ext_t::ctrl_bits__lv_btnm_ctrl_tP"></span><span class="target" id="structlv__btnm__ext__t_1a69fc56d11c2f0f6c8ae6d342372a7d7d"></span><a class="reference internal" href="#_CPPv414lv_btnm_ctrl_t" title="lv_btnm_ctrl_t">lv_btnm_ctrl_t</a> *<code class="sig-name descname">ctrl_bits</code><a class="headerlink" href="#_CPPv4N13lv_btnm_ext_t9ctrl_bitsE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp var">
<dt id="_CPPv4N13lv_btnm_ext_t10styles_btnE">
<span id="_CPPv3N13lv_btnm_ext_t10styles_btnE"></span><span id="_CPPv2N13lv_btnm_ext_t10styles_btnE"></span><span id="lv_btnm_ext_t::styles_btn__lv_style_tCPA"></span><span class="target" id="structlv__btnm__ext__t_1a4b6b687715e9a20c7e162ad2d3791bdc"></span><em class="property">const</em> lv_style_t *<code class="sig-name descname">styles_btn</code>[<code class="sig-name descname">_LV_BTN_STATE_NUM</code>]<a class="headerlink" href="#_CPPv4N13lv_btnm_ext_t10styles_btnE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp var">
<dt id="_CPPv4N13lv_btnm_ext_t7btn_cntE">
<span id="_CPPv3N13lv_btnm_ext_t7btn_cntE"></span><span id="_CPPv2N13lv_btnm_ext_t7btn_cntE"></span><span id="lv_btnm_ext_t::btn_cnt__uint16_t"></span><span class="target" id="structlv__btnm__ext__t_1a534588615474e83e6a013b8de3c56a79"></span>uint16_t <code class="sig-name descname">btn_cnt</code><a class="headerlink" href="#_CPPv4N13lv_btnm_ext_t7btn_cntE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp var">
<dt id="_CPPv4N13lv_btnm_ext_t9btn_id_prE">
<span id="_CPPv3N13lv_btnm_ext_t9btn_id_prE"></span><span id="_CPPv2N13lv_btnm_ext_t9btn_id_prE"></span><span id="lv_btnm_ext_t::btn_id_pr__uint16_t"></span><span class="target" id="structlv__btnm__ext__t_1a0e09420bc5a8e646916e7fd7bbe74a33"></span>uint16_t <code class="sig-name descname">btn_id_pr</code><a class="headerlink" href="#_CPPv4N13lv_btnm_ext_t9btn_id_prE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp var">
<dt id="_CPPv4N13lv_btnm_ext_t10btn_id_actE">
<span id="_CPPv3N13lv_btnm_ext_t10btn_id_actE"></span><span id="_CPPv2N13lv_btnm_ext_t10btn_id_actE"></span><span id="lv_btnm_ext_t::btn_id_act__uint16_t"></span><span class="target" id="structlv__btnm__ext__t_1ae5a9eddf61ec52a1b05f8046bbb48c6a"></span>uint16_t <code class="sig-name descname">btn_id_act</code><a class="headerlink" href="#_CPPv4N13lv_btnm_ext_t10btn_id_actE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp var">
<dt id="_CPPv4N13lv_btnm_ext_t7recolorE">
<span id="_CPPv3N13lv_btnm_ext_t7recolorE"></span><span id="_CPPv2N13lv_btnm_ext_t7recolorE"></span><span id="lv_btnm_ext_t::recolor__uint8_t"></span><span class="target" id="structlv__btnm__ext__t_1afa89c3c2fbbde489b50efe7b34ab37ca"></span>uint8_t <code class="sig-name descname">recolor</code><a class="headerlink" href="#_CPPv4N13lv_btnm_ext_t7recolorE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

<dl class="cpp var">
<dt id="_CPPv4N13lv_btnm_ext_t10one_toggleE">
<span id="_CPPv3N13lv_btnm_ext_t10one_toggleE"></span><span id="_CPPv2N13lv_btnm_ext_t10one_toggleE"></span><span id="lv_btnm_ext_t::one_toggle__uint8_t"></span><span class="target" id="structlv__btnm__ext__t_1a436fe1e0dfbe89c7d1080ba0e7367103"></span>uint8_t <code class="sig-name descname">one_toggle</code><a class="headerlink" href="#_CPPv4N13lv_btnm_ext_t10one_toggleE" title="Permalink to this definition">¶</a><br /></dt>
<dd></dd></dl>

</div>
</dd></dl>

</div>
</div>


           </div>
           
          </div>
          <footer>
  
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
      
        <a href="calendar.html" class="btn btn-neutral float-right" title="Calendar (lv_calendar)" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
      
      
        <a href="btn.html" class="btn btn-neutral float-left" title="Button (lv_btn)" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
      
    </div>
  

  <hr/>

  <div role="contentinfo">
    <p>
        &copy; Copyright 2020, Gabor Kiss-Vamosi
      <span class="lastupdated">
        Last updated on Nov 21, 2020.
      </span>

    </p>
  </div>
  Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/rtfd/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>. 

</footer>

        </div>
      </div>

    </section>

  </div>
  


  <script type="text/javascript">
      jQuery(function () {
          SphinxRtdTheme.Navigation.enable(true);
      });
  </script>

  
  
    
  

 <script type="text/javascript">
    $(document).ready(function() {
        $(".toggle > *").hide();
        $(".toggle .header").show();
        $(".toggle .header").click(function() {
            $(this).parent().children().not(".header").toggle(400);
            $(this).parent().children(".header").toggleClass("open");
        })
    });
</script>


<script type="text/javascript" src="https://docs.lvgl.io/misc/common.js"></script>



</body>
</html>